home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / os2 / fih111.zip / README.1ST < prev    next >
Text File  |  1996-02-22  |  14KB  |  356 lines
  1. ##### ##### ##### #   #       #   # #####      #    #     # ##### #     #
  2.   #   #        #   # ##  #       #   # #     # #   #     # #     ##     #
  3.   #   #        #   # # # #       #   # #    #   #  #     # #     # # #
  4.   #   #        #   # #  ##       ##### ###   #     # #     # ###   #    ##
  5.   #   #        #   # #   #       #   # #     #######    #   #  #     #     #
  6.   #   #        #   # #   #       #   # #     #     #     # #   #     #     #
  7. ##### ##### ##### #   #       #   # ##### #     #      #    ##### #     #
  8.  
  9.  
  10. Welcome to Icon Heaven
  11. the Frobozz icon manager
  12.  
  13. Version 1.11
  14.  
  15. ABOUT ICON HEAVEN
  16.  
  17. Icon Heaven is a Workplace Shell enhancement that simplifies
  18. the task of keeping icon libraries on your disk and assigning icons to
  19. objects. 
  20.  
  21. INSTALLATION
  22.  
  23. Simply unzip this file (FIH.ZIP) into an empty directory and double click 
  24. on the install.cmd object, or, in an OS/2 command session, type 
  25. install+<ENTER>.
  26. The installation procedure will ask you for a directory where 
  27. Icon Heaven should be installed. After selecting a directory, 
  28. the installation procedure will copy all the necessary files to 
  29. that directory and create a number of Workplace Shell objects. 
  30. After the installation terminates, Icon Heaven will be available 
  31. in a folder on the desktop. You can move this folder from
  32. the desktop to any other folder if you wish.
  33.  
  34. The installation procedure can clean up after itself when terminating.
  35. So the directory used to run the installation from will be empty. You 
  36. only have to save the Zip file if you want to do a re-install later.
  37.  
  38. DE-INSTALLATION
  39.  
  40. If, perchance, you really don't like Icon Heaven, you can easily remove it 
  41. from your system. The installation procedure will install a de-install
  42. object in the Icon Heaven folder. Simply double-click on it and answer
  43. the obligatory queries on whether you are absolutely sure you know what
  44. you are doing and Icon Heaven will be removed. During de-install, you can
  45. ignore the dialog box that asks you to confirm closing the de-install
  46. session, it will close by itself anyway.
  47. In most cases, de-install will not be able to remove the file fim.dll
  48. from the Icon Heaven directory. You can delete this file manually later on
  49. after a reboot when the shell unlocks it.
  50.  
  51. RE-INSTALLATION
  52.  
  53. A re-installation procedure called reinst.cmd is also provided. If you
  54. happen to delete the Icon Heaven folder from your system, this program
  55. will recreate it for you, including all the icon folders. Just open an
  56. OS/2 Command Prompt window and run REINST from the directory where 
  57. Icon Heaven is installed.
  58.  
  59. THE APPLICATION
  60.  
  61. Icon Heaven uses a special type of folder, called an Icon Folder, 
  62. to store icons. These icons are not physically stored on disk where 
  63. they would take up far too much diskspace for the occasional time 
  64. you need them. Instead Icon Heaven stores icons in special 
  65. compressed libraries and only expands those when they are
  66. accessed. This reduces the storage cost of an icon to a mere 
  67. 7% of the space needed when using normal icons (on a FAT disk, savings are
  68. less on HPFS).
  69.  
  70. LIBRARIES INCLUDED
  71.  
  72. This package includes a set of five icon libraries. They are:
  73.     - Wordprocessing icons
  74.     - Datacomm icons
  75.     - Games icons
  76.     - Compiler icons
  77.     - Utility icons
  78.     - StarDock icons
  79.  
  80. The StarDock icons were created by the people at StarDock who are doing a lot for
  81. the advancement of OS/2 as a mainstream operating system. They were so kind
  82. to allow the inclusion of their really good-looking icons in Icon Heaven
  83. and deserve a big thanks for all that.
  84.  
  85. OTHER LIBRARIES
  86.  
  87. A separate set of libraries is available for download from the OS2BVEN forum
  88. on CompuServe. This is a big set containing some 2300 converted
  89. Windows icons. There is no need to download these if you already 
  90. have those as they've been roaming the nets for quite some time now.
  91. Please see intructions below for creating your own libraries. The file
  92. is called FIHLIB.ZIP.
  93.  
  94. There is also a set of great icons created by Fred Ng <fredng@io.org>
  95. of Team OS/2 Canada.
  96. You can locate that set at:
  97.     ftp://hobbes.nmsu.edu/multimedia/icons/ticn09i*.zip
  98.  
  99. These are all high-res icons and they look a lot better than the 
  100. ones in fihlib.zip.
  101.  
  102. LATEST RELEASE
  103.  
  104. I have been working on setting up my own web page containing the latest
  105. release of Icon Heaven plus pointers to other stuff I think is useful.
  106. You can access my web page at 
  107.     http://ourworld.compuserve.com/homepages/pvk/frobozz.htm
  108.  
  109. ASSIGNING ICONS
  110.  
  111. Icon Heaven also simplifies assigning icons to objects. Instead of having 
  112. to open the settings for an object and dragging the appropriate icon to 
  113. the General page, icons are assigned by dragging the object to the icon. 
  114. A simple one step operation.
  115.  
  116. Just to avoid an easily made mistake: 
  117.  
  118.     In Icon Heaven you drop the OBJECT on the ICON
  119.     and not the other way round. 
  120.  
  121. Warp users only:
  122.  
  123. The animated icon for a folder can also be assigned directly by pressing
  124. and holding down the control key during the drag operation. Dropping on
  125. an icon with this method will change the second ('open') icon for the folder.
  126.  
  127. RESTRICTIONS
  128.  
  129. In the unregistered version, you are only allowed to assign 10 icons between
  130. after each reboot of your system. This should be enough to evaluate the
  131. product. If you want unlimited usage, you will have to register.
  132.  
  133. MANAGING ICON LIBRARIES
  134.  
  135. Icon Heaven does not restrict you to using the icon libraries provided 
  136. with the software. You can easily expand the libraries provided or 
  137. create your own. This is done using normal Workplace actions, by 
  138. dragging a new Icon Folder from the Icon Folder template (the object
  139. looking like a sticky pad with an icon folder icon within it) in the
  140. Icon Heaven folder or by selecting 'Create another' from 
  141. the popup menu of an existing Icon Folder. Then you can 'connect' 
  142. the folder to a library by opening the settings and 
  143. specifying the name of a new iconlibrary (for instance: 
  144. 'C:\IHeaven\MyIcons.FIM').
  145.  
  146. Now that you've created the library, you can open it and add icons to it.
  147. Adding icons to a library is simply a process of dragging Workplace objects
  148. to the folder (they don't have to be icon files). This will populate the
  149. folder and the library. 
  150.  
  151. Warp users only:
  152.  
  153. If you want to add the animated icon of a folder object to a library, 
  154. drag the object to the icon folder with the control key pressed. (note:
  155. only folders have animated icons)
  156.  
  157. THE ICONLIB TOOL
  158.  
  159. Also included is a library manager called iconlib.exe. It allows you
  160. to list the contents of an icon library, pretty up the names of the icons,
  161. add new icons (icon files only) and set the folder name. This tool is useful 
  162. when you have big directories full of icons and you want to convert them
  163. into Icon Heaven libraries, just type:
  164.  
  165.     iconlib c:\IHeaven\cool.FIM c:\icons\cool\*.ico
  166.  
  167. and all the icons in the cool directory will be added to a Icon Heaven 
  168. library named cool.FIM.
  169. The iconlib tool also has a few other features. For an online help of
  170. the switches supported, just run iconlib without any parameters.
  171.  
  172. REGISTERING
  173.  
  174. Icon Heaven is shareware. You are granted a 30 day trial period to see if you like
  175. the software. Feel free to pass it on to friends, neighbours and colleages...
  176. If you like Icon Heaven, please register it, support the shareware concept.
  177.  
  178. Icon Heaven costs only $15. This is for a single OS/2 system lifetime licence 
  179. including any and all future updates to the product.
  180. You can register Icon Heaven by sending your name and creditcard number plus 
  181. expiration date to:
  182.     CompuServe    75170,1045
  183.     Internet    pvk@acm.org
  184.     fidonet        2:285/324.10
  185.     os2net        81:431/41.10
  186.     mail        P.O.Box 2095
  187.             2240 CB  Wassenaar
  188.             The Netherlands
  189.     fax        +31-70-5111789
  190.     BBS        The Lighthouse BBS
  191.             +31-183-402427
  192.             userid: Paul Van Keep
  193.  
  194. The actual amount debited from your credit card will be slightly higher
  195. than $15, because of fluctuations in international currency rates. Payment 
  196. will be done in dutch guilders, FL 25,- (about $15.40 at the time I write 
  197. this)
  198.  
  199. Private users (not companies) in the European Union but outside
  200. Holland will be charged HFL 30,-, which includes 17.5% Dutch VAT. 
  201. Companies don't have to pay VAT. I don't know why they want to make 
  202. this so hard, but those are the European rules, so I guess the best
  203. thing is to just stick to them.
  204.  
  205. Users (both private & companies) in the Netherlands can also register 
  206. by transferring HFL 30,- to bank account 45.17.71.214, 
  207. tnv Van Keep Software BV. This price includes Dutch VAT. Please mention 
  208. a postal or email address.
  209.  
  210. On CompuServe you can also register through the Shareware Registration
  211. Database. To access the database, use GO SWREG and select 'Register
  212. Shareware'. The registration ID for Icon Heaven is: 2983. The price
  213. for registering Icon Heaven through CompuServe is $20, due to the
  214. high fee CIS claims for handling registrations and the fee my bank wants
  215. for processing a cheque from CIS.
  216.  
  217. On line registration is also possible through Pete Norloff's OS/2 Shareware
  218. BBS (703-385-4325). Registration there will provide users with an instant
  219. registration key, no need to wait for a reply from me. As with CompuServe,
  220. the price there is $20.
  221.  
  222. Finally, registration is now also available through BMT Micro also for
  223. $20. See the order form included in the file BMTORDER.FRM.
  224.  
  225. Registering will get rid of (some of) the troubles with your conscience as
  226. well as the annoying popup of the about dialog the first time you open 
  227. an Icon Folder after a reboot.
  228.  
  229.  
  230. REGISTER SAFELY WITH PGP
  231.  
  232. Better be safe than sorry when sending credit card information over the 
  233. internet. So I'd advise everyone to use PGP to encrypt their registration
  234. message to me. You can use my public key to do this. If you don't have PGP
  235. yet, dowload it from the hobbes site or ftp-os2.cdrom.com (pgp26ui-os2.zip)
  236.  
  237. -----BEGIN PGP PUBLIC KEY BLOCK-----
  238. Version: 2.6
  239.  
  240. mQBNAi9W9HcAAAECAKu2q+guJHDmwYHysN2GBgyIVwlJu6zkQ8dY/TMmk6ZI+ohU
  241. p5ZNyKwz8YWZ6yAqEjrQvuMn6v+p31gq1hJeCDkABRG0G1BhdWwgdmFuIEtlZXAg
  242. PHB2a0BBQ00ub3JnPg==
  243. =qD4Q
  244. -----END PGP PUBLIC KEY BLOCK-----
  245.  
  246. BENIFITS FOR REGISTERED USERS
  247.  
  248. As well as not having a built in limitation to the number of icons
  249. assigend, there is some added functionality to the registered version. 
  250. In the popup menu of each icon a new item will be available: 'Extract'
  251. This will allow you to extract the icon into a plain icon file.
  252. Also you can double click on an icon to invoke the Icon Editor and 
  253. change it. 
  254.  
  255. SUPPORT
  256.  
  257. Support for Icon Heaven is given by the author on the electronic mail 
  258. addresses mentioned above. On CompuServe support is also available in 
  259. the OS2 shareware vendors forum: GO OS2SHARE, section 1
  260.  
  261. CONTENTS
  262.  
  263. This ZIP file FIH.ZIP should contain the following components:
  264.  
  265.     INSTALL.CMD        installation REXX program
  266.     DEINSTAL.CMD        removes Icon Heaven from your system
  267.     REINST.CMD        recreates WpS objects for Icon Heaven
  268.     FIM.DLL            the Icon Heaven WpS classes
  269.     FIM.HLP            Online help
  270.     README.1ST        you're doing it
  271.     ICONLIB.EXE        Icon librarian
  272.     COMM.FIM        Datacomm icons
  273.     CP.FIM            Compiler icons
  274.     GAME.FIM        Game icons
  275.     SDS.FIM            StarDock icons
  276.     UTIL.FIM        Utility icons
  277.     WP.FIM            Wordprocessing icons
  278.     
  279. Please redistribute this zipfile without modifications.
  280.  
  281. DISCLAIMERS
  282.  
  283. Some of the icons included may represent copyrighted or trademarked 
  284. logos. These icons are meant for use with the accompanying
  285. products. All trademarks are owned by their respective companies.
  286.  
  287. This software is sold "as is" and without any warranties whether 
  288. expressed or implied. Because of the various hardware and software 
  289. environments into which this program may be put, no warranty of 
  290. fitness for a particular purpose is offered. Any liability of 
  291. the developer or his agents will be limited exclusively to 
  292. product replacement or refund of pruchase price.
  293.                                                                           
  294. PLANNED ENHANCEMENTS
  295.  
  296. The next major release of Icon Heaven will support renaming of icons (You can 
  297. rename them now, but the changes won't be saved).
  298. Any other suggestions for enhancing Icon Heaven are greatly appreciated.
  299. Please send any mail to one of the adresses above.
  300.  
  301. KNOWN PROBLEMS
  302.  
  303. Don't drag an icon to the general page of an object. For some reason the 
  304. general page does not know how to handle the object being dropped. This
  305. results in drag & drop being unavailable in the whole Workplace Shell (at
  306. least on my system with 2.11).
  307.  
  308. REVISION HISTORY
  309.  
  310. 16-06-94    ver 1.00    Initial release
  311. 14-07-94    ver 1.01    New install procedure, DeskMan/2 support,
  312.                 De-install, iconlib with association
  313.                 sort page restored
  314. 26-07-94    ver 1.02    Copying of icons from one folder to another
  315.                 Deleting icons implemented
  316.                 Improved installation & update
  317. 23-08-94    ver 1.03    Opening an icon folder without a linked 
  318.                 library will popup the settings
  319.                 re-install procedure added.
  320. 19-09-94    ver 1.04    -i(gnore header) option added to iconlib
  321.                 -f fixes lib with broken header
  322.                 better handling of high res icons (not perfect)
  323.                 reinst.cmd added, to recreate objects after
  324.                 a re-install of OS/2
  325. 08-12-94    ver 1.05    Icons are now created using an internal OS/2
  326.                 function. No more problems with blank or
  327.                 wrong resolution icons. Dragging of icons
  328.                 has been disabled.
  329. 06-03-95    ver 1.10    Major overhaul
  330.                 Fixed problems with 1.05 trapping sometimes
  331.                 Icons can now be extracted from libraries
  332.                 using the popup menu and edited with the
  333.                 Icon Editor. Bug fixed where one in two
  334.                 icons would show up blank. Apparently caused
  335.                 by using WinCreatePointerIndirect in a WPS
  336.                 user thread. Solved trap when rebooting
  337.                 with an open icon folder. Added support 
  338.                 for animated folder icons
  339. 21-02-96    ver 1.11    Folder is forced into icon view even when
  340.                 user has another view selected as default
  341.                 (ksnider@amaranth.com).
  342.                 Settings now popup when icon folder is 
  343.                 created from template.
  344.                 Icons are now deleted from a folder when
  345.                 closed. This avoids uncontrolled swapper
  346.                 growth with large icon collections
  347.                 Entryfield for library names was limited to
  348.                 30 positions, has been increased to 256
  349.                 A 'bug' in Lan requester causes the folder
  350.                 object to lose its template. This also affects
  351.                 icons folders. Templating is now forced.
  352.  
  353. The Frobozz Magic Software Company
  354. Paul van Keep
  355. 
  356.